home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / getusershell.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  44 lines
  1.  
  2. GETUSERSHELL(3)            UNIX Programmer's Manual            GETUSERSHELL(3)
  3.  
  4. NNAAMMEE
  5.      ggeettuusseerrsshheellll, sseettuusseerrsshheellll, eenndduusseerrsshheellll - get legal user shells
  6.  
  7. SSYYNNOOPPSSIISS
  8.      _c_h_a_r _*
  9.      ggeettuusseerrsshheellll(_v_o_i_d)
  10.  
  11.      _v_o_i_d
  12.      sseettuusseerrsshheellll(_v_o_i_d)
  13.  
  14.      _v_o_i_d
  15.      eenndduusseerrsshheellll(_v_o_i_d)
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      The ggeettuusseerrsshheellll() function returns a pointer to a legal user shell as
  19.      defined by the system manager in the file _/_e_t_c_/_s_h_e_l_l_s. If _/_e_t_c_/_s_h_e_l_l_s is
  20.      unreadable or does not exist, ggeettuusseerrsshheellll() behaves as if _/_b_i_n_/_s_h and
  21.      _/_b_i_n_/_c_s_h were listed in the file.
  22.  
  23.      The ggeettuusseerrsshheellll() function reads the next line (opening the file if nec-
  24.      essary); sseettuusseerrsshheellll() rewinds the file; eenndduusseerrsshheellll() closes it.
  25.  
  26. FFIILLEESS
  27.      /etc/shells
  28.  
  29. DDIIAAGGNNOOSSTTIICCSS
  30.      The routine ggeettuusseerrsshheellll() returns a null pointer (0) on EOF.
  31.  
  32. SSEEEE AALLSSOO
  33.      shells(5)
  34.  
  35. HHIISSTTOORRYY
  36.      The ggeettuusseerrsshheellll() function appeared in 4.3BSD.
  37.  
  38. BBUUGGSS
  39.      The ggeettuusseerrsshheellll() function leaves its result in an internal static ob-
  40.      ject and returns a pointer to that object. Subsequent calls to
  41.      ggeettuusseerrsshheellll() will modify the same object.
  42.  
  43. 4.3 Berkeley Distribution        June 4, 1993                                1
  44.